package com.witmore.neutron.ai.web.wechat.service;

import com.witmore.neutron.ai.web.wechat.dto.WechatCallbackMessage;

/**
 * 微信回调服务接口
 * Author: 豆子高
 * Date: 2025/12/19
 */
public interface WechatCallbackService {
    
    /**
     * 处理微信回调消息
     *
     * @param message 回调消息
     * @return 回复消息内容
     */
    String handleCallback(WechatCallbackMessage message);
    
    /**
     * 处理关注事件
     *
     * @param openId 用户openId
     * @param eventKey 事件key（包含场景值）
     * @param ticket 二维码ticket
     * @return 处理结果
     */
    boolean handleSubscribeEvent(String openId, String eventKey, String ticket);
    
    /**
     * 保存用户信息
     *
     * @param openId 用户openId
     * @param phone 手机号
     * @param sceneStr 场景值
     * @return 是否保存成功
     */
    boolean saveUserInfo(String openId, String phone, String sceneStr);
}
